USPS Pricing Engine Web Service 


May 21, 2015 


Summary 
This is the Domestic and International Pricing Engine Web Services (version 11.2.0.0) for the April 2015 
Release. The following is a list of enhancements included in this release. 


Prices 


1001 - Prices cells changing - Price Tables 
Most prices have been updated. 


Domestic and International Pricing Engine 


Delete Customer Type map CNSB_Retail_Stamps_009R4 
Delete the Domestic and International customer maps for OO9R4 CNSB Retail Stamps. The following 
error message will now be returned when the Customer Type is OO9R4: 


We are unable to complete your request. This application now requires the identification of a 
payment method — (postage meter, permit, eVS). Please close out and restart the application to 
get the latest version 


Domestic Pricing Engine 


1300-285 - FCM parcels moved to competitive 

First-Class Mail Parcel Retail has been moved to First-Class Package Service. The First-Class Mail Parcel 
(Mail service ID 7) mail service will no longer be returned by the Pricing Engine. The First-Class Retail 
price is now being returned as the Retail “R” Postage Price for the First-Class Package Service (Mail 
service ID 55). 


This update has not been approved to move to Production, system has been reverted back to the 
original state. 


1900-283 - Simplify Extra Service Offerings 

Changes have been made to the Domestic Pricing Engine to implement Simplify Extra Service Offerings. 
These changes include adding new extra services and removing obsolete extra services. Extra service 
combinations have also been modified per the requirements. All the customer maps have been updated 
to include and remove the extra services allowed for each customer type. 


Extra Services Added 


170 Certified Mail Restricted Delivery 








May 21, 2015 Release 11.2.0.0 update 5 Page 1of9 








Certified Mail Adult Signature Required 

Certified Mail Adult Signature Restricted Delivery 
Signature Confirmation Restricted Delivery 

Signature Confirmation Electronic Restricted Delivery 
Collect on Delivery Restricted Delivery 

Registered Mail Restricted Delivery 

Insurance Restricted Delivery 

Insurance Restricted Delivery (PME) 

Insurance Restricted Delivery (PM) 

Insurance Restricted Delivery (bulk only) 

Special Handling — Fragile 

Special Handling — Hazardous Material Transportation 
Special Handling — Live Animal Transportation 

Special Handling — Perishables 

Special Handling — Cremated Remains 
























































Extra Services Removed 
111 Restricted Delivery 
113 Special Handling 
157 Special Handling 




















The Pricing Engine allows for the new “Special Handling” extra services to be specified as the Mail Piece 
Content. Reference the following tables for content and price detail keys: 


Content Keys 

Key Description 

LiveAnimals The mail piece content is a Live Animal(s). 

Equivalent to Special Handling - Live Animal Transportation 
DayOldPoultry The mail piece content is a Live Animal(s) that is Day Old Poultry. 
Hazmat The mail piece content is Hazmet. 

Equivalent to Special Handling - Hazardous Material Transportation 
GroundTransportation The mail piece requires Ground Transportation. 

Nonmachinable The mail piece is Not Machinable. 

CrematedRemains The mail piece content is Cremated Remains 

Equivalent to Special Handling - Cremated Remains 

Perishables The mail piece content is Perishable. 

Equivalent to Special Handling - Perishables 

Fragile The mail piece content is Fragile 

Equivalent to Special Handling - Fragile 



































Price Detail Keys 
Key Description 
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Live Animal Fee 





Sunday/Holiday Fee 





10:30 AM Delivery Fee 





Nonmachinable Fee 





Base Price 











Fragile Fee 





International Pricing Engine 


2100-271 - One Americas Zone pricing 

Changes have been made to the International Pricing Engine to implement Canadian zone pricing. When 
requesting rates for Priority Mail International to Canada the 3-digit Origin ZIP code and the first digit of 
the Destination Postal code is now required. The Pricing Engine will also accept the 5-digit Origin ZIP 
code and any number of digits for the Destination Postal code. 


Structure change 
An errors section has been added to the International ServicesWithPricing class. This section contains a 
collect of error numbers/ messages objects. 


GetServicesWithPricing method 
If the specified country is Canada and the Origin ZIP code and/or Destination Postal code is not specified 
in the request; an error will be returned in the new error section of the ServicesWithPricing class. 


CalculateServicePrice method 
If the specified country is Canada and the Origin ZIP code and/or Destination Postal code is not specified 
in the request; an exception will be thrown. 


2101 - Updating Prohibitions, Restrictions, and Observations in the Individual Country 
Listings. (Regulatory) 


Tokelau - regulatory 
e Changed parent country from Western Samoa to New Zealand 
e Changed from PMEI price group 6 to price group 10 
e Changed from PMI price group 6 to price group 10 
e Changed Name to "Tokelau (New Zealand)" 
e Changed CountryNumber to 244 
e Changed Code to (NZ) 


Western Samoa - regulatory 
e Changed name from “Western Samoa” to “Samoa” - 10512 
e Changed child countries to end with "(Samoa)” 
o Atafu (Samoa) - 10505 
o Fakaofo (Samoa) - 10506 
o Nukunonu (Samoa) - 10507 
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o Savaii Island (Samoa) - 10508 
o Upolu Island (Samoa) - 10511 


Saint (St.) Christopher - regulatory 


e Changed name from “Saint Christopher and Nevis” to " Saint (St.) Kitts and Nevis " - 10400 


e Changed child countries to end with "(Saint (St.) Kitts and Nevis)" 
o Nevis (Saint (St.) Kitts and Nevis) - 10399 
o Saint Kitts (Saint (St.) Kitts and Nevis) - 10401 


2102 - Additional Countries for PMEI (with Price Group) 
Priority Mail Express International will now be returned for the following countries 


Burma 





Myanmar (Burma) 





Canton Island (Kiribati) 





Christmas Island (Kiribati) 





Enderbury Island (Kiribati) 





Fanning Island (Kiribati) 





Gilbert Islands (Kiribati) 





Kiribati 





Ocean Island (Kiribati) 











Sao Tome and Principe 





URLs 


Domestic 
http://dbservices.usps.com/PricingServices.asmx 


International 
http://ibservices.usps.com/PricingServices.asmx 
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Reported Defects 


ID Title Status 

2730 | Weight limit in error message is wrong. Corrected 
3264 | 1001 - Registered Mail COD Showing wrong fee value Corrected 
3306 | 2102 - Extra Services are not available for Burma, Kiribati and Sao Tome and Corrected 
Principe 
3413 | 1900-283 - Simplify Extra Service Offerings - eVS is not returning all requested Corrected 
Extra Services 
3489 | 1900-283 - Simplify Extra Service Offerings - USPS Tracking should be returned for | Corrected 
FCM, MM, LM, BPM 
3529 | 1900-283 - Simplify Extra Service Offerings - Incorrect Rate for PME and PM Corrected 
Insurance 
3577 | 1900-283 - Simplify Extra Service Offerings - Incorrect Loss Limit for Registered Corrected 
Mail 
3627 | 1001 - Prices cells changing - Price Tables - Incorrect price for Parcel Select 70 Ibs Corrected 
3632 | 1001 - Prices cells changing - Price Tables - Incorrect Prices for FCM Flats and Corrected 
Parcels 3 ounces 
3637 | 1900-283 - Simplify Extra Service Offerings - Insurance Restricted Delivery should Corrected 
display an warning when < $500 
3644 | 1900-283 - Simplify Extra Service Offerings - Footnotes should have Loss Limit as Corrected 
$50,000.00 
3671 | 1900-283 - Simplify Extra Service Offerings - Incorrect Extra Services for Corrected 
APO/FPO/DPO 
3676 | 1300-285 - FCM parcels moved to competitive - Incorrect error message Corrected 
3682 | 2100-271 - One Americas Zone pricing - Incorrect Max Weight for Canada Corrected 
3687 | 2100-271 - One Americas Zone pricing - Capitalize Postal Code Corrected 
3893 | 1900-283 - Simplify Extra Service Offerings - Remove Return Receipt Electronic Corrected 
from Insurance over $500 
4079 | CR EDDM Prices are incorrect when weight is greater than 3.5 oz Corrected 
4084 | Incorrect Extra Services for some Mail Service and Combinations Corrected 










































































2730 Weight limit in error message is wrong 


International Pricing Engine 

Problem: 

Error message regarding weight is wrong. This is in regard to the mail services that have a limit of 4 
pounds. The error message says 20 pounds as the limit instead of the 4. 


3264 1001 - Registered Mail COD Showing wrong fee value 


Domestic Pricing Engine 
Problem: 
In COD Registered table, the fee is showing a different value than the spreadsheet. 


In the Database, the fee is 5.15 
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In the spreadsheet, the fee is 5.90 


3306 2102 - Extra Services are not available for Burma, Kiribati and Sao Tome 
and Principe 


International Pricing Engine 
Problem: 
No extra services are being returned 


3413 1900-283 - Simplify Extra Service Offerings - eVS is not returning all 
requested Extra Services 


Domestic Pricing Engine 

Problem: 

eVS Comm. Base is missing the following Extra Services 011B6 
170 - Certified Mail Restricted Delivery 

171 - Certified Mail Adult Signature Required 

172 - Certified Mail Adult Signature Restricted Delivery 

174 - Signature Confirmation™ Electronic Restricted Delivery 


eVS Comm. Plus is missing the following Extra Services 011P6 
174 - Signature Confirmation™ Electronic Restricted Delivery 


3489 1900-283 - Simplify Extra Service Offerings - USPS Tracking should be 
returned for FCM, MM, LM, BPM 


Domestic Pricing Engine 
Problem: 
Add USPS Tracking to Media Mail, Library Mail, BPM Parcels and First-Class Package Service 


3529 1900-283 - Simplify Extra Service Offerings - Incorrect Rate for PME and 
PM Insurance 


Domestic Pricing Engine 

Problem: 

When the declared value is $12 for PME and PM in the domestic retail calc. and a fee is showing — 
should be No Charge. 
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3577 1900-283 - Simplify Extra Service Offerings - Incorrect Loss Limit for 
Registered Mail 


Domestic Pricing Engine 

Problem: 

For both domestic business and retail: 

Liability for loss or damage is limited up to $25,000.00. 
Should now be: 

Liability for loss or damage is limited up to $50,000.00. 


3627 1001 - Prices cells changing - Price Tables - Incorrect price for Parcel 
Select 70 lbs 


Domestic Pricing Engine 
Problem: 
e For Parcel Select ONDC Presort, the Oversized prices is being returned for the 70lb price 
e For Parcel Select — Nonpresort, the Oversized prices are being returned for the 70lb price 
e For Parcel Select Destination Entry — Nonmachinable, the Oversized prices are being returned 
for the 70lb price 


3632 1001 - Prices cells changing - Price Tables - Incorrect Prices for FCM 
Flats and Parcels 3 ounces 


Domestic Pricing Engine 
Problem: 
The following calculators are returning 4 ounce prices when the user enters 3 ounces: 


FCM Flats - Automation Flats 

FCM Flats - Nonautomation Flats 

FCM Flats - Roundtrip DVD, CD or Other Disc Automation Flats 
FCM Flats - Roundtrip DVD, CD or Other Disc Nonautomation Flats 
First-Class Package Service Retail 3 ounce is showing 4 ounce price 


3637 1900-283 - Simplify Extra Service Offerings - Insurance Restricted 
Delivery should display an warning when < $500 


Domestic Pricing Engine 
Problem: 
Should display warning about Insurance Restricted Delivery must be more than $500 
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3644 1900-283 - Simplify Extra Service Offerings - Footnotes should have Loss 
Limit as $50,000.00 


Domestic Pricing Engine 
Problem: 
Footnotes states the Liability for loss or damage is limited up to $25,000.00, should be $50,000.00 


3671 1900-283 - Simplify Extra Service Offerings - Incorrect Extra Services for 
APO/FPO/DPO 


Domestic Pricing Engine 
Problem: 
APO/FPO/DPO Extra Service rules need to be applied to the new Extra Services 


3676 1300-285 - FCM parcels moved to competitive - Incorrect error message 


Domestic Pricing Engine 

Problem: 

If we submit a weight >= 16 ounces for "R" or "CB" the following error message is returned: 
"The entered weight must be less than 16 ounces" 


If we submit a weight > 13 and <= 16 ounces for "R" or "CB" we get the standard error message back 
from the pricing engine: 
"The requested Mail Service is not available for the specified customer type." 


Correct Behavior: 
The error message for "R" and "CB" should be: 
"The entered weight must be less than or equal to 13 ounces" 


The error message for "CP" should be: 
"The entered weight must be less than 16 ounces" 


3682 2100-271 - One Americas Zone pricing - Incorrect Max Weight for 
Canada 


International Pricing Engine 

Problem: 

The max weight for Canada PMI is 66lbs — we should change the 7Olbs to say 66lbs for Retail, CB, and CP 
(ibcalc) 
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3687 2100-271 - One Americas Zone pricing - Capitalize Postal Code 


International Pricing Engine 

Problem: 

The user is required to input the Canada Postal Code in All Caps or it will not accept it. Could we put 
something directly under "Destination Postal Code" that says (Postal Code must be in all caps) or 
something like that? 


Solution: 
Capitalize Postal Code below checking database for zone 


1900-283 - Simplify Extra Service Offerings - Remove Return Receipt 
Electronic from Insurance over $500 

Problem: 

The product owner is requesting that Return Receipt Electronic not be allowed as an additional Extra 
Service when paired with insurance greater than $500. The product owner is stating that the customer 
can receive signature service and proof of delivery with only the purchase of insurance greater than 
$500 via Track and Confirm. Therefore, the Rate Engine will remove the option of purchasing Return 
Receipt Electronic for items when insurance greater than $500 is purchased. The Rate Engine will still 
allow customers to purchase Return Receipt (hardcopy) with insurance greater than $500. 


4079 - CR EDDM Prices are incorrect when weight is greater than 3.5 oz 


Problem: 
Standard mail and Nonprofit Standard Mail 
EDDM Letters (Standard Mail Saturation Letters) 


Up to 3.5 oz receives automation saturation prices with only a per piece price, this includes listed prices 
of up to 3.3 oz and over 3.3 up to 3.5 oz. (Std M automation prices only go up to 3.5 oz) 

Over 3.5 oz up to 16 oz receives Nonautomation saturation prices with a per piece price and a per Ib 
price. 


4048 - Incorrect Extra Services for some Mail Service and Combinations 
Problem: 
1. Standard Mail Automation Letters should not have "USPS Tracking Electronic" 
2. Standard Mail Automation Flats should not have "USPS Tracking Electronic" 
3. Return Receipt should be returned when "Signature Confirmation Restricted Delivery" is 
selected 
hazmat should not return "Media Mail", "Library Mail" and "BPM" 
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